/**
 * Original Author -> 杨海健 (taketoday@foxmail.com) https://taketoday.cn
 * Copyright © TODAY & 2017 - 2021 All Rights Reserved.
 *
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see [http://www.gnu.org/licenses/]
 */
package cn.taketoday.web.http;

/**
 * Enumeration of HTTP status codes.
 *
 * <p>The HTTP status code series can be retrieved via {@link #series()}.
 *
 * <p>
 * From Spring
 *
 * @author Arjen Poutsma
 * @author Sebastien Deleuze
 * @author Brian Clozel
 * @author TODAY 2020/12/6 15:51
 * @see HttpStatus.Series
 * @see <a href="https://www.iana.org/assignments/http-status-codes">HTTP Status Code Registry</a>
 * @see <a href="https://en.wikipedia.org/wiki/List_of_HTTP_status_codes">List of HTTP status codes - Wikipedia</a>
 * @since 3.0
 */
public enum HttpStatus {

  // 1xx Informational

  /**
   * {@code 100 Continue}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.2.1">HTTP/1.1: Semantics and Content, section 6.2.1</a>
   */
  CONTINUE(100, "Continue"),
  /**
   * {@code 101 Switching Protocols}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.2.2">HTTP/1.1: Semantics and Content, section 6.2.2</a>
   */
  SWITCHING_PROTOCOLS(101, "Switching Protocols"),
  /**
   * {@code 102 Processing}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc2518#section-10.1">WebDAV</a>
   */
  PROCESSING(102, "Processing"),
  /**
   * {@code 103 Checkpoint}.
   *
   * @see <a href="https://code.google.com/p/gears/wiki/ResumableHttpRequestsProposal">A proposal for supporting
   * resumable POST/PUT HTTP requests in HTTP/1.0</a>
   */
  CHECKPOINT(103, "Checkpoint"),

  // 2xx Success

  /**
   * {@code 200 OK}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.3.1">HTTP/1.1: Semantics and Content, section 6.3.1</a>
   */
  OK(200, "OK"),
  /**
   * {@code 201 Created}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.3.2">HTTP/1.1: Semantics and Content, section 6.3.2</a>
   */
  CREATED(201, "Created"),
  /**
   * {@code 202 Accepted}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.3.3">HTTP/1.1: Semantics and Content, section 6.3.3</a>
   */
  ACCEPTED(202, "Accepted"),
  /**
   * {@code 203 Non-Authoritative Information}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.3.4">HTTP/1.1: Semantics and Content, section 6.3.4</a>
   */
  NON_AUTHORITATIVE_INFORMATION(203, "Non-Authoritative Information"),
  /**
   * {@code 204 No Content}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.3.5">HTTP/1.1: Semantics and Content, section 6.3.5</a>
   */
  NO_CONTENT(204, "No Content"),
  /**
   * {@code 205 Reset Content}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.3.6">HTTP/1.1: Semantics and Content, section 6.3.6</a>
   */
  RESET_CONTENT(205, "Reset Content"),
  /**
   * {@code 206 Partial Content}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7233#section-4.1">HTTP/1.1: Range Requests, section 4.1</a>
   */
  PARTIAL_CONTENT(206, "Partial Content"),
  /**
   * {@code 207 Multi-Status}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc4918#section-13">WebDAV</a>
   */
  MULTI_STATUS(207, "Multi-Status"),
  /**
   * {@code 208 Already Reported}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc5842#section-7.1">WebDAV Binding Extensions</a>
   */
  ALREADY_REPORTED(208, "Already Reported"),
  /**
   * {@code 226 IM Used}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc3229#section-10.4.1">Delta encoding in HTTP</a>
   */
  IM_USED(226, "IM Used"),

  // 3xx Redirection

  /**
   * {@code 300 Multiple Choices}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.4.1">HTTP/1.1: Semantics and Content, section 6.4.1</a>
   */
  MULTIPLE_CHOICES(300, "Multiple Choices"),
  /**
   * {@code 301 Moved Permanently}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.4.2">HTTP/1.1: Semantics and Content, section 6.4.2</a>
   */
  MOVED_PERMANENTLY(301, "Moved Permanently"),
  /**
   * {@code 302 Found}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.4.3">HTTP/1.1: Semantics and Content, section 6.4.3</a>
   */
  FOUND(302, "Found"),
  /**
   * {@code 302 Moved Temporarily}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc1945#section-9.3">HTTP/1.0, section 9.3</a>
   * @deprecated in favor of {@link #FOUND} which will be returned from {@code HttpStatus.valueOf(302)}
   */
  @Deprecated
  MOVED_TEMPORARILY(302, "Moved Temporarily"),
  /**
   * {@code 303 See Other}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.4.4">HTTP/1.1: Semantics and Content, section 6.4.4</a>
   */
  SEE_OTHER(303, "See Other"),
  /**
   * {@code 304 Not Modified}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7232#section-4.1">HTTP/1.1: Conditional Requests, section 4.1</a>
   */
  NOT_MODIFIED(304, "Not Modified"),
  /**
   * {@code 305 Use Proxy}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.4.5">HTTP/1.1: Semantics and Content, section 6.4.5</a>
   * @deprecated due to security concerns regarding in-band configuration of a proxy
   */
  @Deprecated
  USE_PROXY(305, "Use Proxy"),
  /**
   * {@code 307 Temporary Redirect}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.4.7">HTTP/1.1: Semantics and Content, section 6.4.7</a>
   */
  TEMPORARY_REDIRECT(307, "Temporary Redirect"),
  /**
   * {@code 308 Permanent Redirect}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7238">RFC 7238</a>
   */
  PERMANENT_REDIRECT(308, "Permanent Redirect"),

  // --- 4xx Client Error ---

  /**
   * {@code 400 Bad Request}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.1">HTTP/1.1: Semantics and Content, section 6.5.1</a>
   */
  BAD_REQUEST(400, "Bad Request"),
  /**
   * {@code 401 Unauthorized}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7235#section-3.1">HTTP/1.1: Authentication, section 3.1</a>
   */
  UNAUTHORIZED(401, "Unauthorized"),
  /**
   * {@code 402 Payment Required}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.2">HTTP/1.1: Semantics and Content, section 6.5.2</a>
   */
  PAYMENT_REQUIRED(402, "Payment Required"),
  /**
   * {@code 403 Forbidden}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.3">HTTP/1.1: Semantics and Content, section 6.5.3</a>
   */
  FORBIDDEN(403, "Forbidden"),
  /**
   * {@code 404 Not Found}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.4">HTTP/1.1: Semantics and Content, section 6.5.4</a>
   */
  NOT_FOUND(404, "Not Found"),
  /**
   * {@code 405 Method Not Allowed}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.5">HTTP/1.1: Semantics and Content, section 6.5.5</a>
   */
  METHOD_NOT_ALLOWED(405, "Method Not Allowed"),
  /**
   * {@code 406 Not Acceptable}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.6">HTTP/1.1: Semantics and Content, section 6.5.6</a>
   */
  NOT_ACCEPTABLE(406, "Not Acceptable"),
  /**
   * {@code 407 Proxy Authentication Required}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7235#section-3.2">HTTP/1.1: Authentication, section 3.2</a>
   */
  PROXY_AUTHENTICATION_REQUIRED(407, "Proxy Authentication Required"),
  /**
   * {@code 408 Request Timeout}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.7">HTTP/1.1: Semantics and Content, section 6.5.7</a>
   */
  REQUEST_TIMEOUT(408, "Request Timeout"),
  /**
   * {@code 409 Conflict}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.8">HTTP/1.1: Semantics and Content, section 6.5.8</a>
   */
  CONFLICT(409, "Conflict"),
  /**
   * {@code 410 Gone}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.9">
   * HTTP/1.1: Semantics and Content, section 6.5.9</a>
   */
  GONE(410, "Gone"),
  /**
   * {@code 411 Length Required}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.10">
   * HTTP/1.1: Semantics and Content, section 6.5.10</a>
   */
  LENGTH_REQUIRED(411, "Length Required"),
  /**
   * {@code 412 Precondition failed}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7232#section-4.2">
   * HTTP/1.1: Conditional Requests, section 4.2</a>
   */
  PRECONDITION_FAILED(412, "Precondition Failed"),
  /**
   * {@code 413 Payload Too Large}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.11">
   * HTTP/1.1: Semantics and Content, section 6.5.11</a>
   */
  PAYLOAD_TOO_LARGE(413, "Payload Too Large"),
  /**
   * {@code 413 Request Entity Too Large}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc2616#section-10.4.14">HTTP/1.1, section 10.4.14</a>
   * @deprecated in favor of {@link #PAYLOAD_TOO_LARGE} which will be
   * returned from {@code HttpStatus.valueOf(413)}
   */
  @Deprecated
  REQUEST_ENTITY_TOO_LARGE(413, "Request Entity Too Large"),
  /**
   * {@code 414 URI Too Long}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.12">
   * HTTP/1.1: Semantics and Content, section 6.5.12</a>
   */
  URI_TOO_LONG(414, "URI Too Long"),
  /**
   * {@code 414 Request-URI Too Long}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc2616#section-10.4.15">HTTP/1.1, section 10.4.15</a>
   * @deprecated in favor of {@link #URI_TOO_LONG} which will be returned from {@code HttpStatus.valueOf(414)}
   */
  @Deprecated
  REQUEST_URI_TOO_LONG(414, "Request-URI Too Long"),
  /**
   * {@code 415 Unsupported Media Type}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.13">
   * HTTP/1.1: Semantics and Content, section 6.5.13</a>
   */
  UNSUPPORTED_MEDIA_TYPE(415, "Unsupported Media Type"),
  /**
   * {@code 416 Requested Range Not Satisfiable}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7233#section-4.4">HTTP/1.1: Range Requests, section 4.4</a>
   */
  REQUESTED_RANGE_NOT_SATISFIABLE(416, "Requested range not satisfiable"),
  /**
   * {@code 417 Expectation Failed}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.5.14">
   * HTTP/1.1: Semantics and Content, section 6.5.14</a>
   */
  EXPECTATION_FAILED(417, "Expectation Failed"),
  /**
   * {@code 418 I'm a teapot}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc2324#section-2.3.2">HTCPCP/1.0</a>
   */
  I_AM_A_TEAPOT(418, "I'm a teapot"),
  /**
   * @deprecated See
   * <a href="https://tools.ietf.org/rfcdiff?difftype=--hwdiff&url2=draft-ietf-webdav-protocol-06.txt">
   * WebDAV Draft Changes</a>
   */
  @Deprecated
  INSUFFICIENT_SPACE_ON_RESOURCE(419, "Insufficient Space On Resource"),
  /**
   * @deprecated See
   * <a href="https://tools.ietf.org/rfcdiff?difftype=--hwdiff&url2=draft-ietf-webdav-protocol-06.txt">
   * WebDAV Draft Changes</a>
   */
  @Deprecated
  METHOD_FAILURE(420, "Method Failure"),
  /**
   * @deprecated See <a href="https://tools.ietf.org/rfcdiff?difftype=--hwdiff&url2=draft-ietf-webdav-protocol-06.txt">
   * WebDAV Draft Changes</a>
   */
  @Deprecated
  DESTINATION_LOCKED(421, "Destination Locked"),
  /**
   * {@code 422 Unprocessable Entity}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc4918#section-11.2">WebDAV</a>
   */
  UNPROCESSABLE_ENTITY(422, "Unprocessable Entity"),
  /**
   * {@code 423 Locked}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc4918#section-11.3">WebDAV</a>
   */
  LOCKED(423, "Locked"),
  /**
   * {@code 424 Failed Dependency}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc4918#section-11.4">WebDAV</a>
   */
  FAILED_DEPENDENCY(424, "Failed Dependency"),
  /**
   * {@code 425 Too Early}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc8470">RFC 8470</a>
   */
  TOO_EARLY(425, "Too Early"),
  /**
   * {@code 426 Upgrade Required}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc2817#section-6">Upgrading to TLS Within HTTP/1.1</a>
   */
  UPGRADE_REQUIRED(426, "Upgrade Required"),
  /**
   * {@code 428 Precondition Required}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc6585#section-3">Additional HTTP Status Codes</a>
   */
  PRECONDITION_REQUIRED(428, "Precondition Required"),
  /**
   * {@code 429 Too Many Requests}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc6585#section-4">Additional HTTP Status Codes</a>
   */
  TOO_MANY_REQUESTS(429, "Too Many Requests"),
  /**
   * {@code 431 Request Header Fields Too Large}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc6585#section-5">Additional HTTP Status Codes</a>
   */
  REQUEST_HEADER_FIELDS_TOO_LARGE(431, "Request Header Fields Too Large"),
  /**
   * {@code 451 Unavailable For Legal Reasons}.
   *
   * @see <a href="https://tools.ietf.org/html/draft-ietf-httpbis-legally-restricted-status-04">
   * An HTTP Status Code to Report Legal Obstacles</a>
   */
  UNAVAILABLE_FOR_LEGAL_REASONS(451, "Unavailable For Legal Reasons"),

  // --- 5xx Server Error ---

  /**
   * {@code 500 Internal Server Error}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.6.1">HTTP/1.1: Semantics and Content, section 6.6.1</a>
   */
  INTERNAL_SERVER_ERROR(500, "Internal Server Error"),
  /**
   * {@code 501 Not Implemented}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.6.2">HTTP/1.1: Semantics and Content, section 6.6.2</a>
   */
  NOT_IMPLEMENTED(501, "Not Implemented"),
  /**
   * {@code 502 Bad Gateway}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.6.3">HTTP/1.1: Semantics and Content, section 6.6.3</a>
   */
  BAD_GATEWAY(502, "Bad Gateway"),
  /**
   * {@code 503 Service Unavailable}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.6.4">HTTP/1.1: Semantics and Content, section 6.6.4</a>
   */
  SERVICE_UNAVAILABLE(503, "Service Unavailable"),
  /**
   * {@code 504 Gateway Timeout}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.6.5">HTTP/1.1: Semantics and Content, section 6.6.5</a>
   */
  GATEWAY_TIMEOUT(504, "Gateway Timeout"),
  /**
   * {@code 505 HTTP Version Not Supported}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc7231#section-6.6.6">HTTP/1.1: Semantics and Content, section 6.6.6</a>
   */
  HTTP_VERSION_NOT_SUPPORTED(505, "HTTP Version not supported"),
  /**
   * {@code 506 Variant Also Negotiates}
   *
   * @see <a href="https://tools.ietf.org/html/rfc2295#section-8.1">Transparent Content Negotiation</a>
   */
  VARIANT_ALSO_NEGOTIATES(506, "Variant Also Negotiates"),
  /**
   * {@code 507 Insufficient Storage}
   *
   * @see <a href="https://tools.ietf.org/html/rfc4918#section-11.5">WebDAV</a>
   */
  INSUFFICIENT_STORAGE(507, "Insufficient Storage"),
  /**
   * {@code 508 Loop Detected}
   *
   * @see <a href="https://tools.ietf.org/html/rfc5842#section-7.2">WebDAV Binding Extensions</a>
   */
  LOOP_DETECTED(508, "Loop Detected"),
  /**
   * {@code 509 Bandwidth Limit Exceeded}
   */
  BANDWIDTH_LIMIT_EXCEEDED(509, "Bandwidth Limit Exceeded"),
  /**
   * {@code 510 Not Extended}
   *
   * @see <a href="https://tools.ietf.org/html/rfc2774#section-7">HTTP Extension Framework</a>
   */
  NOT_EXTENDED(510, "Not Extended"),
  /**
   * {@code 511 Network Authentication Required}.
   *
   * @see <a href="https://tools.ietf.org/html/rfc6585#section-6">Additional HTTP Status Codes</a>
   */
  NETWORK_AUTHENTICATION_REQUIRED(511, "Network Authentication Required");

  private final int value;

  private final String reasonPhrase;

  HttpStatus(int value, String reasonPhrase) {
    this.value = value;
    this.reasonPhrase = reasonPhrase;
  }

  /**
   * Return the integer value of this status code.
   */
  public int value() {
    return this.value;
  }

  /**
   * Return the reason phrase of this status code.
   */
  public String getReasonPhrase() {
    return this.reasonPhrase;
  }

  /**
   * Return the HTTP status series of this status code.
   *
   * @see HttpStatus.Series
   */
  public Series series() {
    return Series.valueOf(this);
  }

  /**
   * Whether this status code is in the HTTP series
   * {@link Series#INFORMATIONAL}.
   * This is a shortcut for checking the value of {@link #series()}.
   *
   * @see #series()
   */
  public boolean is1xxInformational() {
    return (series() == Series.INFORMATIONAL);
  }

  /**
   * Whether this status code is in the HTTP series
   * {@link Series#SUCCESSFUL}.
   * This is a shortcut for checking the value of {@link #series()}.
   *
   * @see #series()
   */
  public boolean is2xxSuccessful() {
    return (series() == Series.SUCCESSFUL);
  }

  /**
   * Whether this status code is in the HTTP series
   * {@link Series#REDIRECTION}.
   * This is a shortcut for checking the value of {@link #series()}.
   *
   * @see #series()
   */
  public boolean is3xxRedirection() {
    return (series() == Series.REDIRECTION);
  }

  /**
   * Whether this status code is in the HTTP series
   * {@link Series#CLIENT_ERROR}.
   * This is a shortcut for checking the value of {@link #series()}.
   *
   * @see #series()
   */
  public boolean is4xxClientError() {
    return (series() == Series.CLIENT_ERROR);
  }

  /**
   * Whether this status code is in the HTTP series
   * {@link Series#SERVER_ERROR}.
   * This is a shortcut for checking the value of {@link #series()}.
   *
   * @see #series()
   */
  public boolean is5xxServerError() {
    return (series() == Series.SERVER_ERROR);
  }

  /**
   * Whether this status code is in the HTTP series
   * {@link Series#CLIENT_ERROR} or
   * {@link Series#SERVER_ERROR}.
   * This is a shortcut for checking the value of {@link #series()}.
   *
   * @see #is4xxClientError()
   * @see #is5xxServerError()
   */
  public boolean isError() {
    return (is4xxClientError() || is5xxServerError());
  }

  /**
   * Return a string representation of this status code.
   */
  @Override
  public String toString() {
    return this.value + " " + name();
  }

  /**
   * Return the enum constant of this type with the specified numeric value.
   *
   * @param statusCode
   *         the numeric value of the enum to be returned
   *
   * @return the enum constant with the specified numeric value
   *
   * @throws IllegalArgumentException
   *         if this enum has no constant for the specified numeric value
   */
  public static HttpStatus valueOf(int statusCode) {
    HttpStatus status = resolve(statusCode);
    if (status == null) {
      throw new IllegalArgumentException("No matching constant for [" + statusCode + "]");
    }
    return status;
  }

  /**
   * Resolve the given status code to an {@code HttpStatus}, if possible.
   *
   * @param statusCode
   *         the HTTP status code (potentially non-standard)
   *
   * @return the corresponding {@code HttpStatus}, or {@code null} if not found
   */
  public static HttpStatus resolve(int statusCode) {
    for (HttpStatus status : values()) {
      if (status.value == statusCode) {
        return status;
      }
    }
    return null;
  }

  /**
   * Enumeration of HTTP status series.
   * <p>Retrievable via {@link HttpStatus#series()}.
   */
  public enum Series {

    INFORMATIONAL(1),
    SUCCESSFUL(2),
    REDIRECTION(3),
    CLIENT_ERROR(4),
    SERVER_ERROR(5);

    private final int value;

    Series(int value) {
      this.value = value;
    }

    /**
     * Return the integer value of this status series. Ranges from 1 to 5.
     */
    public int value() {
      return this.value;
    }

    /**
     * Return the enum constant of this type with the corresponding series.
     *
     * @param status
     *         a standard HTTP status enum value
     *
     * @return the enum constant of this type with the corresponding series
     *
     * @throws IllegalArgumentException
     *         if this enum has no corresponding constant
     */
    public static Series valueOf(HttpStatus status) {
      return valueOf(status.value);
    }

    /**
     * Return the enum constant of this type with the corresponding series.
     *
     * @param statusCode
     *         the HTTP status code (potentially non-standard)
     *
     * @return the enum constant of this type with the corresponding series
     *
     * @throws IllegalArgumentException
     *         if this enum has no corresponding constant
     */
    public static Series valueOf(int statusCode) {
      Series series = resolve(statusCode);
      if (series == null) {
        throw new IllegalArgumentException("No matching constant for [" + statusCode + "]");
      }
      return series;
    }

    /**
     * Resolve the given status code to an {@code HttpStatus.Series}, if possible.
     *
     * @param statusCode
     *         the HTTP status code (potentially non-standard)
     *
     * @return the corresponding {@code Series}, or {@code null} if not found
     */
    public static Series resolve(int statusCode) {
      int seriesCode = statusCode / 100;
      for (Series series : values()) {
        if (series.value == seriesCode) {
          return series;
        }
      }
      return null;
    }
  }

}
